home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 1.iso / dist / fw_curl.idb / usr / freeware / include / curl / easy.h.z / easy.h
C/C++ Source or Header  |  2002-07-08  |  3KB  |  69 lines
  1. #ifndef __CURL_EASY_H
  2. #define __CURL_EASY_H
  3. /*****************************************************************************
  4.  *                                  _   _ ____  _     
  5.  *  Project                     ___| | | |  _ \| |    
  6.  *                             / __| | | | |_) | |    
  7.  *                            | (__| |_| |  _ <| |___ 
  8.  *                             \___|\___/|_| \_\_____|
  9.  *
  10.  * Copyright (C) 1998 - 2002, Daniel Stenberg, <daniel@haxx.se>, et al.
  11.  *
  12.  * In order to be useful for every potential user, curl and libcurl are
  13.  * dual-licensed under the MPL and the MIT/X-derivate licenses.
  14.  *
  15.  * You may opt to use, copy, modify, merge, publish, distribute and/or sell
  16.  * copies of the Software, and permit persons to whom the Software is
  17.  * furnished to do so, under the terms of the MPL or the MIT/X-derivate
  18.  * licenses. You may pick one of these licenses.
  19.  *
  20.  * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
  21.  * KIND, either express or implied.
  22.  *
  23.  * $Id: easy.h,v 1.6 2002/03/19 07:54:55 bagder Exp $
  24.  *****************************************************************************/
  25. #ifdef  __cplusplus
  26. extern "C" {
  27. #endif
  28.  
  29. CURL *curl_easy_init(void);
  30. CURLcode curl_easy_setopt(CURL *curl, CURLoption option, ...);
  31. CURLcode curl_easy_perform(CURL *curl);
  32. void curl_easy_cleanup(CURL *curl);
  33.  
  34. /*
  35.  * NAME curl_easy_getinfo()
  36.  *
  37.  * DESCRIPTION
  38.  *
  39.  * Request internal information from the curl session with this function.  The
  40.  * third argument MUST be a pointer to a long, a pointer to a char * or a
  41.  * pointer to a double (as the documentation describes elsewhere).  The data
  42.  * pointed to will be filled in accordingly and can be relied upon only if the
  43.  * function returns CURLE_OK.  This function is intended to get used *AFTER* a
  44.  * performed transfer, all results from this function are undefined until the
  45.  * transfer is completed.
  46.  */
  47. CURLcode curl_easy_getinfo(CURL *curl, CURLINFO info, ...);
  48.  
  49.  
  50. /*
  51.  * NAME curl_easy_duphandle()
  52.  *
  53.  * DESCRIPTION
  54.  *
  55.  * Creates a new curl session handle with the same options set for the handle
  56.  * passed in. Duplicating a handle could only be a matter of cloning data and
  57.  * options, internal state info and things like persistant connections cannot
  58.  * be transfered. It is useful in multithreaded applications when you can run
  59.  * curl_easy_duphandle() for each new thread to avoid a series of identical
  60.  * curl_easy_setopt() invokes in every thread.
  61.  */
  62. CURL* curl_easy_duphandle(CURL *curl);
  63.  
  64. #ifdef  __cplusplus
  65. }
  66. #endif
  67.  
  68. #endif
  69.